WMS - Android 13 Instructions

As part of our support for Android 13+, when upgrading to version 17.03.009, there are a few additional instructions that will need to be performed one time after the update. This is due to changing our communication protocol from TCP to HTTPS, which improves our security and performance.

For Cloud Customers

When you first start up each scanner:

  1. The WMS application will self-update.
  2. On each device, instead of using the IP address and port number, connect to the Deacom Cloud URL and port number provided by ECI. For example,[https://www.DEACOMCLOUDURL.com:PORT]https://www.DEACOMCLOUDURL.com:PORT.
    1. Note, this will not be the automation service port, it will be a separate WMS port number provided by ECI.

For On-Premise Customers

To Connect WMS via HTTPS

  1. In the deacom.ini file, add a new row and set WMSHTTPSPORT= to a free port.
  2. . Add a firewall rule for it using the following command and replacing both X’s with the chosen port from step 1:
    1. netsh advfirewall firewall add rule name="WMS HTTPS Port X" dir=in action=allow protocol=TCP localport=X
  3. 3. Obtain a publicly signed certificate for SSL authentication
    1. If you already have one, continue to the next step
  4. Get the thumbprint. You can accomplish this by navigating to Certificate Manager (certmgr.msc) and browsing to the Certificate. Open it and go to the detail tab, scroll down to thumbprint. Note/Copy the thumbprint.

Generate a new GUID using PowerShell

  1. Run Windows PowerShell as administrator.
  2. Enter the following:
    1. $appid = [guid]::NewGuid().ToString() and hit enter
  3. This will store the GUID to the variable appid
  4. Then enter: $appid and hit enter
  5. This will print out the GUID. Copy it down somewhere and note which system/port it will be attached to.
  6. In the following, replace X with the port from step 1, replace certhere with the certificate from step 4, and replace yourappid with the GUID from step 9:
    1. netsh http add sslcert ipport=0.0.0.0:X certhash=certhere appid="{$yourappid}"
    2. Example: netsh http add sslcert ipport=192.2.3.43:443 certhash=abcdef1234567890abcdef1234567890abcdef12 appid="{12345678-1234-1234-1234-1234567890ab}”
  7. Stop and start the automation service and confirm it is still running after 1 minute
  8. Test connection by using a browser and go to the following URL. Replace YOURDEACOMURL with your Deacom URL and PORT with the Port from step 1:
    1. For example: https://www.YOURDEACOMURL.com:PORT/wms/checkconnection
  9. If you receive an empty xml response, the connection is confirmed. If the host cannot be reached, double check the steps above.
  10. On each WMS Scanner device, connect to your Deacom URL and port number from step 1.
    1. For example, https://www.YOURDEACOMURL.com:PORT

To Connect WMS via HTTP

  1. In the deacom.ini file, add a new row and set WMSHTTPPORT= to a free port.
  2. Stop and start the automation service and confirm it is still running after 1 minute
  3. Test connection by using a browser and go to the following URL. Replace IPAddress with the same IP Address currently being used for WMS and PORT with the Port from step 1:
    1. For example: http://IPAddress:WMSHTTPPORT/wms/checkconnection
  4. If you receive an empty xml response, the connection is confirmed. If the host cannot be reached, double check the steps above.
  5. On each WMS Scanner device, connect to your Deacom URL and port number from step 1.
    1. For example, https://www.YOURDEACOMURL.com:PORT